audio_form object

This method will create a status bar and return a control ID.

int create_status_bar(string caption, string text)

Parameters:
caption
The title of the status bar.
text
The text of the status bar.

Return value:
A control ID that can be used to check the status of the control, or -1 on error.

Remarks:
Prepending any letter in the caption string with an ampersand (&) sign will cause a shortcut to be created for the status bar. For example, &Operation will cause alt+o to be the shortcut for the status bar.

Example:
// Make a simple form with a few buttons and a status bar.

#include "form.bgt"

audio_form form;

void main()
{
form.create_window("Example Form", true);
int status=form.create_status_bar("&Operation", "This program is working properly.");
int ok=form.create_button("OK");
int cancel=form.create_button("E&xit");
while(true)
{
form.monitor();
wait(5);
if(form.is_pressed(ok))
{
exit();
}
if(form.is_pressed(cancel))
{
exit();
}
if((key_down(KEY_LMENU))&&(key_pressed(KEY_F4)))
{
exit();
}
}
}